BBS Toolkit/BBS Toolkit.iso/doors_1/jlut500.zip/HLP.ZIP/IL.HLP

Text File | 1992-07-10 | 14KB | 370 lines

┌─────────────────────────────────┐
│ Option:  IL  INSPECT GT-LOGFILE │
└─────────────────────────────────┘

┌─Explanation────────────────────────────────────────────────────────────────┐
└────────────────────────────────────────────────────────────────────────────┘

  I am very proud about this option. Please sit down, if you are not
  sitting at the moment, make a break and concentrate at this text.

  This option is one of the most powerful options of JLUTIL. It examines
  the GT.LOG File for bad passwords, transmittions, your own entries and
  so on. It writes messages to the users, which include the exact date
  and time of eg. a bad password usage.

  Please read GENEARL.HLP to setup the message names correctly within
  JL.CNF. The MessageFiles must be in the JLPATH Directory or in a
  SubDirectory, if you have specified it.

  GT fails sometimes. GT writes an <EOF> and appends data after this.
  Normally a program, which scans GT.LOG, will stop reading the file
  after it has detected the <EOF> mark, but not JLUTIL, which skips
  the <EOF> and continues reading the GT.LOG File.

  There are several parameters and switches available. The Default is
  NO Parameter and NO Switch. Without the -DMYL Switches JLUTIL checks
  the whole GT.LOG File. If you want to produce reports of a specific
  time interval, you have to edit your GT.LOG and then to run JLUTIL /IL
  or use the -DMYL Switches. Without the -U Switch, JLUTIL will not
  write a report to the user. Without the -S Switch, JLUTIL will not
  write a report to the sysop. If you don't use the S nor the -U Switch,
  JLUTIL will send out no reports.





  ┌─EXPLANATION OF THE POSSIBLE PARAMETERS─────────────────────────┐
  └────────────────────────────────────────────────────────────────┘
  ┌─┐
  │P│  BAD PASSWORD
  └─┘

  If you want to check for bad passwords, JLUTIL will scan the GT.LOG
  File for such entries and will inform the user and/or the sysop.
  Perhaps you want to add the following line into your midnight batch
  at 24:01:  JLUTIL /IL P -USD.

  ┌─┐
  │D│  DENIED ACTIONS
  └─┘

  If you want to check for denied actions, JLUTIL will scan the GT.LOG
  File for such entries and will inform the user and/or the sysop.

  ┌─┐
  │T│  TRASH CONNECTIONS
  └─┘

  If you want to check for trash connections, JLUTIL will scan the GT.LOG
  File for such entries and will inform the user and/or the sysop.

  ┌─┐
  │R│  RECEIVED FILES
  └─┘

  If you want to check for received files, JLUTIL will scan the GT.LOG
  File for such entries and will inform the user and/or the sysop.

  ┌─┐
  │S│  SENDED FILES
  └─┘

  If you want to check for sended files, JLUTIL will scan the GT.LOG
  File for such entries and will inform the user and/or the sysop.

  ┌─┐
  │X│  TIME USAGE REPORT
  └─┘

  If you want to check for BBS-Time Usage, JLUTIL will scan the GT.LOG
  File for such entries and will inform the user and/or the sysop.

  ┌─┐
  │M│  MISCELLANEOUS REPORT
  └─┘

  If you want to check for miscellaneous, JLUTIL will scan the GT.LOG
  File for such entries and will inform the user and/or the sysop.

  ┌─┐
  │O│  DOOR USAGE
  └─┘

  If you want to check for door usage, JLUTIL will scan the GT.LOG
  File for such entries and will inform the user and/or the sysop.

  ┌─┐
  │N│  NETMAIL
  └─┘

  If you use this parameter, JLUTIL will scan the GTNET.LOG File
  and will inform the sysop. IF you use this Parameter, you have
  to set up the File MONEY01.@JL. Read this File for more informations.
  This option generates two files: A-MMYYNOD.NET and C-MMYYNOD.NET.
  The first file stores the answered calls and the second stores the
  calls done by your system. If you run this option may, 1992 and your
  system would be 803/000, /IL N -S would generate A-0592000.803 and
  C-0592000.803 and write the report into JL{NET}.TXT.

  ┌─┐
  │Z│  HANDLE IL-CMD.@JL
  └─┘

  If you want to check for your own entries, JLUTIL will scan the GT.LOG
  File for such entries and will inform the user and/or the sysop. You
  have to setup the IL-CMD.@JL File. How you can do this, please read the
  description within this file.

  ┌─┐
  │U│  NETMAIL REPORT FILES
  └─┘

  If you use this parameter, JLUTIL will scan the A-MMYYNOD.NET and
  C-MMYYNOD.NET files (eg. A-0592000.803 and C-0592000.803) and write
  the report into JL{NET}.TXT. Read the description of N for more
  informations. Here is an example:

  ▓       SEPTEMBER 1990
  ▓
  ▓ ┌──> C───────────────#─────────────────────RX───────────TX─────CPS┐
  ▓ │    │ 050/001      14  00:25.47       233878        88257     208│
  ▓ │    │ 200/000       2  00:04.44            0            0       0│
  ▓ │    └────────────────────────────────────────────────────────────┘
  ▓ │            2      16  00:30.31       233878        88257     104
  ▓ │      ─────┬─ ───┬───  ───┬──── ─────┬────── ─────┬────── ┌──────
  ▓ │           │     │        │          │            │       │
  ▓ │           │     │        │          │            │       └ mean cps
  ▓ └ C for     │     │        │          │            └ sended bytes
  ▓   CONNECTS  │     │        │          └ received bytes
  ▓             │     │        └ 30 min total connect time
  ▓             │     └ 16 calls total
  ▓             └ 803/000 called 2 systems
  ▓
  ▓ ┌──> V────────────────────────────────────────────────────────────┐
  ▓ │    │    0.00    0.00      0.00         0.00         0.00    0.00│
  ▓ │    └────────────────────────────────────────────────────────────┘
  ▓ └ V for   1*       2*        3*           4*           5*       6*
  ▓   VALUE
  ▓
  ▓       * 1. Number of connected systems divided through number of
  ▓            answered systems. Because there are no answered systems,
  ▓            this value is 0.
  ▓
  ▓       * 2. Number of connect calls divided through number of
  ▓            answered calls.
  ▓
  ▓       * 3. Connect time of connect calls divided through connect time
  ▓            of answered calls.
  ▓
  ▓       * 4. Received bytes from called systems through sended
  ▓            bytes to answered systems.
  ▓
  ▓       * 5. Sended bytes to called systems through received
  ▓            bytes from answered systems.
  ▓
  ▓       * 6. SYSTEM VALUE. Mean of 1 to 5.
  ▓
  ▓ ┌──> T────────────────────────────────────────────────────────────┐
  ▓ │    │       2      16  00:30.31       322135         0.00     176│
  ▓ │    └────────────────────────────────────────────────────────────┘
  ▓ │           *1      *2      *3           *4            *5       *6
  ▓ │
  ▓ │          * 1: Total systems
  ▓ └ T for    * 2: Total connects (calls and answers)
  ▓   TOTAL    * 3: Total connect time
  ▓            * 4: Total transferred bytes
  ▓            * 5: SYSTEM VALUE
  ▓            * 6: Total CPS
  ▓
  ▓         The SYSTEM VALUE summarizes the performace of your system. If
  ▓         the system is zero, your system's performace is very bad
  ▓         and you are collecting only. If it is between zero and one,
  ▓         you are collecting more than you are distributing. And
  ▓         the higher the system value is, the more you are distributing
  ▓         your collected bytes, calls, etc. A value greater 4 is great
  ▓         and if you have a value of 10, your system can't be beaten.
  ▓         Same as V.6.
  ▓
  ▓         The TOTAL CPS is the sended and received bytes from all systems
  ▓         through total connect time with called and answered systems. This
  ▓         value is different from the mean cps value, because the mean cps
  ▓         value adds all cps values and divides it through the number
  ▓         of systems. This value here also takes care of the connect
  ▓         time of each system. It is a better value for the performance
  ▓         of your system.


  ┌─┐
  │G│  ALL NETMAIL REPORT FILES
  └─┘

  If you use this parameter, JLUTIL will scan all A-MMYYNOD.NET and
  C-MMYYNOD.NET files in JLPATH and write the report into JL{NET}.TXT.
  Read the description of N and U for more informations.


  ┌─EXPLANATION OF THE POSSIBLE SWITCHES───────────────────────────┐
  └────────────────────────────────────────────────────────────────┘

  ┌─┐
  │U│  USER
  └─┘

  If you specify this switch, JLUTIL will send messages to the users.
  If not, JLUTIL will not inform the user. Sometimes you want a report,
  but you don't want, that the users will get a report. This switch
  enables you to determine, if the user and/or the sysop will get a
  report.

  ┌─┐
  │S│  SYSOP
  └─┘

  Look also at U... USER. If you specify this switch, JLUTIL will send
  summaries to you.

  ┌─┐
  │D│  PREVIOUS DAY
  └─┘

  Normally JLUTIL will scan the whole GT.LOG File. If you specify this
  switch, JLUTIL will only scan the entries of the last day.

  ┌─┐
  │M│  PREVIOUS MONTH
  └─┘

  If you specify this switch, JLUTIL will only scan the entries of the
  last month. If JLUTIL detects a date within GT.LOG, which is lower
  than the date of the previous line, it will increase the year. If
  there are two lines like

  09-17 21:57   ; BOOTING
  08-17 21:57   ; BOOTING
  09-17 21:57   ; BOOTING

  JLUTIL will detect, that the date of the second line is lower than
  that of the first file (09-17 | 08-17) and will increase the year.
  This can cause trouble, if a date is invalid. So please check your
  GT.LOG from time to time or if JLUTIL fails.

  ┌─┐
  │Y│  PREVIOUS YEAR
  └─┘

  If you specify this switch, JLUTIL will only scan the entries of the
  last year.

  ┌─┐
  │L│  LAST xx DAYS
  └─┘

  If you specify this switch, JLUTIL will only scan the entries of the last
  xx days. If you specify for example -L14, JLUTIL will scan the entries
  of the last 14 days only. Together with the /DATE command (read
  GENERAL.HLP for more informations), you are able to handle several
  different reports, which contain these time-intervals you need. So
  it is perhaps necessary to check everyday for bad passwords, but it
  is not very necessary to check everyday for time usage. If you
  want to check this, you should use the M Switch or perhaps -L7.

  ┌─┐
  │I│  INVOICES
  └─┘

  If you use this switch, JLUTIL will send out the normal messages
  and will also write an invoice, which contains the summary of
  all checked actions. This gives the user an overview, what he
  has done - short and precise.

  ┌─┐
  │O│  LOGGED ON USERS TO JLPATH\LOGGEDON.TXT
  └─┘

  If you use this switch, JLUTIL will rewrite the file JLPATH\LOG-
  GEDON.TXT and add all users, which have been online during the
  scanned time interval. Together with /MO option, this will help
  you to save time. /MO is able to handle a TagFile. JLPATH\LOGGEDON.TXT
  is such a TagFile. So you have no longer to scan the levels of
  all users, if you want to check the levels of these user, who
  have been online during the last 14 days for example.


  ┌─┐
  │A│  DISPLAY THE DATES WHILE CHECKING THE LOGFILES
  └─┘

  If you use this switch, JLUTIL will display the dates, while
  checking the LogFiles. This can be very useful, if you want to
  see, if JLUTIL handles the year correct or why JLUTIL doesn't
  send out any reports. Use this switch, if you are not satisfied
  with the normal display.


  ┌─┐
  │N│  SEND HUB REPORTS TO THE SYSOPS VIA NETMAIL
  └─┘

  If you use this switch, JLUTIL will send HUB Reports to the
  Sysops via NetMail, if JLUTIL analyzes GTNET.LOG.


  ┌─┐
  │B│  SAVE ANALYZED LOGFILES IN JL{LOG}.GES
  └─┘

  If you use this switch, JLUTIL will save the file JL{LOG}.GES



┌─Syntax─────────────────────────────────────────────────────────────────────┐
└────────────────────────────────────────────────────────────────────────────┘
  JLUTIL /IL  [Parameters] [-Switches]


┌─Switch──────Description────────────────────────────────────────────────────┐
└────────────────────────────────────────────────────────────────────────────┘
   -D         Last (previous) day only (is equal to -L1).
   -M         Last (previous) month only
   -Y         Last (previous) Year only
   -S         Summary Report to Sysop
   -U         Report to User
   -Lxx       Last xx Days (eg. -L7 = last seven days)
   -I         Send Invoices
   -O         Write Names of logged on Users to JLPATH\LOGGEDON.TXT
   -A         Display the dates while checking the LogFiles
   -N         Send HUB Reports to the Sysops via NetMail
   -B         Save analyzed LogFiles in JL{LOG}.GES

┌─Parameter───Description────────────────────────────────────────────────────┐
└────────────────────────────────────────────────────────────────────────────┘
    P         BAD PASSWORDS
    D         DENIED ACTIONS
    T         TRASH CONNECTIONS
    R         RECEIVED FILES
    S         SENDED FILES
    X         TIME USAGE REPORT
    M         MISCELLANEOUS REPORT
    O         DOOR USAGE
    N         NETMAIL
    Z         HANDLE IL-CMD.@JL
    U         NETMAIL REPORT FILES
    G         ALL NETMAIL REPORT FILES

┌─Examples───────────────────────────────────────────────────────────────────┐
└────────────────────────────────────────────────────────────────────────────┘

  JLUTIL /IL P    -USD
  JLUTIL /IL RS   -USL7 /DATE[1]
  JLUTIL /IL X    -USM  /DATE 1
  JLUTIL /IL DTMO -USM  /DATE 1
  JLUTIL /IL Z    -USM  /DATE 1

  JLUTIL /IL -OL14 /MO LOGGEDON.TXT -T